AndrewTheArt's Beat2x Beat Generator v3.1 - Linux Edition (1/12/07)

What it is
**********
A very simple "step file" (.bxe) generator for the Beat2x interpreter. This version run in Mono in Linux, and behaves exactly the same as the Windows versions that runs with the .NET Framework.

It basically plays any .wav, .mp3, .ogg , and possibly other formats (any format that mplayer accepts), while allowing you to create a .bxe file simultaneously with some key presses. It certainly beats going into Audacity and looking for the milliseconds.

Requirements and Notes
***********

This version requires and performs correctly with the following packages- 

(1) mono-core (version 1.2.5)
(2) mono-winforms (version 1.2.5)
(3) mplayer (version 1.0rc2, although most if not all versions should theoretically work - check in the packman repository) or another audio player that plays the formats you want (check out config.ini)
(4) dos2unix (to allow the program to convert the .bxe to the UNIX format after you're done)

Optionally - (5) audacity (only if you want to me prompted to convert your file to ogg)

If I have left out a requirement, please forgive me. If this program does not run with these requirements, install more mono packages as you see fit. However, I am fairly certain it will run with these installed.

To determine what versions of the above programs you do or do not have installed either click on the "Help/About" box at the top right of the program or open up a console and type in things like

mono --version
mplayer --version

...etc


If I have left out a requirement, please forgive me. If this program does not run with these requirements, install more mono packages as you see fit. However, I am fairly certain it will run with these installed.

To determine what versions of the above programs you do or do not have installed either click on the "Help/About" box at the top right of the program or open up a console and type in things like

mono --version
mplayer --version

...etc

You package manager should assist you here greatly.

More notes - 

(1) It accepts the .wav, .mp3, and .ogg file formats, and any format that mplayer supports.
(2) No support for "patterns" yet (DEFINES) - this should come in a future update.
(3) It might be a little slow to load - be patient

Other than this, simply run the "Beat2x Beat Generator.exe" executable with mono in the "Files" folder. In Gnome at least, you should be able to right click, select "Open with other application", and search for or select select "mono".

As a last resort, or for debugging purposes, point your console to this folder and type

mono "Beat2x Beat Generator.exe"

You will of course need to keep the entire "Beat2x Beat Generator v3" folder on your computer somewhere for later use.

Updates/Enhancements as of 1/12/07 (version 3.1 Linux)
***********
 
(1) Modified the algorithm to calculate the time elapsed from the time the player starts to the time a key is pressed - Much more accurate (was a huge problem with the Linux version)
(2) Added a file called config.ini that lets you choose the media play you want the program to use. Has a total of two option at the moment but this will expend in the future.
(3) Added a line that converts the final .bxe file to a UNIX text file using dos2unix (hope you have it installed :P)
(4) Added massive amounts of exception catching (Linux version)
(5) Added a lot of exception catching (Linux version)

Updates/Enhancements as of version 3.0 Linux
***********

The Linux version of the Beat Generator provides no new real functionality from the Windows version of the Beat Generator. However, I would like to point out - 

(1) Using mplayer should allow you to playback virtually any file format.
(2) There is much more Linux- centric exception catching in this version, for things like file permissions, etc
(3) The "Help/About" button on the top right displays basic information about your mono and mplayer version - useful for debugging purposes.


Past Additions
***********

(1) Now allows for use of arrow keys for recording instead of alphabetical keys!!! (Actually, you can use both now - your choice)
(2) Major GUI Upgrade
(1) Accepts any kid of .wav, .ogg, or .mp3 file, possibly even the .midi format. (Haven't tried MIDI yet)
(2) Much more stable (more exception catching)
(3) Interface improvements
(4) Ability to create multiple files without the program crashing
(5) Automatic creation of the .bxe file (versus renaming a .txt file)


FAQ
************

Q. How can I put the files onto the gp2x and play it back in the Beat2x Game
A. A wonderful tutorial on who to use the .bxe file this program creates is located here - http://www.gp2x.de/cgi-bin/cfiles.cgi?0,0,0,0,23,1364.

Q. On the gp2x, the audio and notes are not in sync.
A. This is probably because the program's internal timer begins before the music is actually played back (the mplayer process is spawned) - meaning that you need to be ready to hit the keys you desire as soon as the timer runs out. You can and might need to use the delay/offset function added in version 3 to insert a delay after the timer hits 0 to give you a few milliseconds to react.


Comments on Kraven's Beat Generator
************
This was in no way to compete with Kraven's Pascal-based Step generator. I have the original idea, released a relatively crappy product, and he decided to improve on it. Now I'm releasing a more stable and functional product for your enjoyment. In fact, we're probably going to be working together on making a Beat2X step generator suite for all your Step2X needs (= So don't worry.


Credits/Version
***********
Programmed entirely by Andrew Stein (AndrewTheArt)  
Contact: andrewtheartist@hotmail.com
Version 3.1 Linux (1/12/07)
Created initially on 6/17/07, Ported to Mono on 1/4/08
